home *** CD-ROM | disk | FTP | other *** search
/ Workbench Designer 2 / Workbench Designer 2.iso / workbench-tools / fullpalette / docsenglish / fullpalette.doc < prev   
Encoding:
Text File  |  1997-07-26  |  9.1 KB  |  241 lines
  1.  
  2.  
  3.               =================================================
  4.               FullPalette 40.17 (26.7.97) by Massimo Tantignone
  5.               =================================================
  6.  
  7.  
  8.    INTRODUCTION
  9.  
  10.    FullPalette is a patch that, together with a preferences editor, allows
  11. you to define and save ALL the 256 Workbench colors and not just eight of
  12. them as the standard Palette editor does.
  13.  
  14.    You can decide exactly which colors are to be "locked", and thus never
  15. modified by programs running on the Workbench screen, and which colors
  16. instead are to be left "free" for IPrefs and other applications.
  17.  
  18.    Among other advantages, this makes the managing of icons much easier;
  19. using FullPalette you can, for example, have icons with any number of
  20. colors without risking to see some of them change just because you view
  21. a picture with MultiView on the Workbench screen.
  22.    You could also set colors 4-7 to always be the same as colors 252-255.
  23.  
  24.    FullPalette also has a button strip to easily perform editing actions
  25. such as "Copy", "Swap" and "Spread".
  26.  
  27.    For the purpose of editing the Workbench palette, FullPalette can
  28. wholly replace the standard "Palette" preferences editor, whose settings
  29. file (palette.prefs) it continues to maintain for compatibility, although
  30. FullPalette also uses a custom file.
  31.  
  32.    The patch runs alongside IPrefs with no conflicts.
  33.  
  34.  
  35.    INSTALLATION
  36.  
  37.    Installing FullPalette is very simple. You only have to do three things:
  38.  
  39.    1) Copy the FPPrefs program into a directory that is in the system path
  40.       (for example C:)
  41.  
  42.    2) Insert into your Startup-sequence, IMMEDIATELY AFTER IPREFS, the
  43.       following line:
  44.  
  45.       Run > NIL: FPPrefs
  46.  
  47.    3) Copy the FullPalette editor (with its icon) into the Prefs drawer
  48.       of your Workbench partition.
  49.  
  50.    Now you can reboot to activate the patch, then play with the editor to
  51. edit and save the Workbench palette according to your preferences.
  52.    The Workbench screen will use your palette each time it (re)opens itself.
  53.  
  54.    Note: you CAN'T call FPPrefs from the User-startup; if you do, some images
  55. (especially backgrounds) on the Workbench screen could be rendered with
  56. the wrong colors.
  57.  
  58.  
  59.    USAGE
  60.  
  61.    Once you have the FPPrefs patch running in the background you can use
  62. the FullPalette editor to define your palette.
  63.  
  64.    To edit the entire palette of the Workbench screen, you should first open
  65. it with the maximum number of colors available (256 for AGA and graphic
  66. cards, 16 for ECS).
  67.  
  68.    This way, you can edit all colors; then, each time the Workbench screen
  69. will open at less than its maximum depth, only some of the colors will be
  70. used.
  71.  
  72.    The FullPalette GUI is very intuitive. You have some gadgets to perform
  73. actions like "Copy" or "Spread" at the top of the window; below there is
  74. a palette gadget for choosing the palette entry to edit, and a cycle
  75. gadget to specify if you want the current color to be "Free" or "Locked".
  76.  
  77.    There are also two text indicators with the logical and physical number
  78. of the current color. The logical number is the color index in the current
  79. palette, whereas the physical number always refers to the color index in
  80. the full 256-color palette.
  81.  
  82.    Three sliders allow you to modify the Red, Green and Blue components of
  83. the current color, and the gadgets at the bottom of the window give you
  84. the option to Save, Use or Cancel the current settings.
  85.  
  86.    You can use some tool types in FullPalette's icon (or keywords on the
  87. command line):
  88.  
  89.    SCREEN          tells FullPalette to open on a custom screen
  90.    FONTNAME=<name> specifies the name of the font for the editor window
  91.    FONTSIZE=<size> specifies the size of the font for the editor window
  92.  
  93.    Furthermore, the editor recognizes the usual preferences tool types,
  94. such as EDIT, SAVE, USE and CREATEICONS=<YES|NO>.
  95.  
  96.    Starting with version 40.14, FullPalette allows you to choose the
  97. precision of the color remapping for Workbench backdrop images.
  98.    You can select the wanted precision within the menu "Options".
  99.    Note that any change takes effect only when the Workbench screen is
  100. reopened.
  101.  
  102.  
  103.    BEHAVIOR WHEN STARTING
  104.  
  105.    By default, FullPalette immediately sets the Workbench colors to your
  106. preferences when it starts. At boot time, this has the side effect of opening
  107. the Workbench screen if it isn't already open.
  108.    You can tell it to wait until the Workbench screen (re)opens itself by
  109. setting the environment variable "ENV:FullPalette/Action".
  110.  
  111.    With the command "SetEnv FullPalette/Action IMMEDIATE" you tell
  112. FullPalette to immediately set the colors when it is launched, thus opening
  113. the Workbench screen if it isn't already open. This is the default.
  114.  
  115.    With the command "SetEnv FullPalette/Action DEFERRED" you tell
  116. FullPalette to wait until the Workbench screen opens by itself before
  117. setting the colors.
  118.  
  119.    Once you have set the variable, make sure you copy them into ENVARC:
  120. with, for instance, the command "Copy ENV:FullPalette/#? ENVARC:FullPalette"
  121. (the ENVARC:FullPalette directory must be created first).
  122.  
  123.    Note: the "deferred" behavior is experimental, normally it works well but
  124. it seems that once in a while it can lock up the screen at boot time. If
  125. this happens, just do a manual reset (CTRL-Amiga-Amiga).
  126.    If it happens too often on your machine, return to the default behavior
  127. (immediate) by deleting the environment variable.
  128.  
  129.  
  130.    THE COLOR MODE
  131.  
  132.    You can set the environment variable "ENV:FullPalette/ColorMode" to choose
  133. how FullPalette should remap the full (physical) 256-color palette to
  134. the current (logical) color palette of the Workbench screen, if it has less
  135. than 256 colors.
  136.  
  137.    With the command "SetEnv FullPalette/ColorMode WORKBENCH" you tell
  138. FullPalette to set the current palette's first half to the colors at the
  139. beginning of the full 256-color palette, and the second half to the colors
  140. at the end. In other words, a 32-color Workbench screen will get its first
  141. 16 colors from the first 16 colors of the 256-color palette, and its second
  142. 16 colors from the LAST 16 colors of the 256-color palette.
  143.  
  144.    With the command "SetEnv FullPalette/ColorMode LINEAR" you tell
  145. FullPalette to set the current palette to the first colors of the 256-color
  146. palette, except for the last 4 color which will be always taken from the
  147. end of the 256-color palette.
  148.    This way, a 32-color Workbench screen will get its first 28 colors from
  149. the first 28 colors of the 256-color palette, and its last 4 colors from
  150. the last 4 colors of the 256-color palette.
  151.  
  152.    Either way, this is compatible with IPrefs, which uses the notorious
  153. "first 4/last 4" color scheme.
  154.  
  155.  
  156.    NOTES
  157.  
  158.    At the moment FullPalette doesn't have a color wheel, and probably it
  159. never will, as it would be impossible to allocate all the necessary pens
  160. for it from the same palette the wheel would be used to modify.
  161.    From my personal experience, however, the color wheel is rather useless
  162. in an application like this one (a palette editor for the Workbench screen).
  163.  
  164.    Furthermore, at the moment it also lacks an HSB mode as an alternative
  165. to the RGB one; if I'll receive enough requests, I'll implement it for sure.
  166.  
  167.    Important: if the cycle gadget of the editor says "Free", this does NOT
  168. mean that the selected color is _currently_ free, but just that it will
  169. never be locked by FullPalette!
  170.    However, it's possibile to know which pens are currently free or
  171. allocated: by pressing any SHIFT key while selecting (with a mouse click)
  172. a palette color, if the corresponding pen is allocated you'll see the
  173. screen flash.
  174.  
  175.  
  176.    CHANGES
  177.  
  178.    40.12    First public beta release
  179.  
  180.    40.13    Some bug-fixes:
  181.  
  182.             · Now FPPrefs doesn't change a palette entry if it wasn't
  183.               saved as "Locked".
  184.  
  185.             · Now FPPrefs does nothing when OpenWorkBench() is called with
  186.               the Workbench screen already open.
  187.  
  188.             · The FullPalette editor now saves and loads only the colors
  189.               which are "Locked".
  190.  
  191.    40.14    Bug-fix:
  192.  
  193.             · Now FPPrefs should work better with NewIcons.
  194.  
  195.             New:
  196.  
  197.             · Added (experimental) option for choosing the precision
  198.               of the Workbench pattern remapping. Let me know if it works!
  199.  
  200.    40.15    Bug-fix:
  201.  
  202.             · There was a bug in the italian .catalog file.
  203.  
  204.             New:
  205.  
  206.             · Now the editor allocates the needed stack by itself.
  207.  
  208.    40.16    Bumped revision to 16 for the Aminet release
  209.  
  210.    40.17    Bug-fix:
  211.  
  212.             · Fixed a bug in the editor, wasn't always leaving enough
  213.               space for the slider level numbers.
  214.  
  215.             New:
  216.  
  217.             · Added the (still experimental) ability to defer the setting
  218.               of colors at boot time, thus avoiding an unwanted opening of
  219.               the Workbench screen.
  220.  
  221.  
  222.    CONCLUSION
  223.  
  224.    I have used FullPalette on my system for many months now, and it never
  225. gave me any trouble. However, this doesn't necessarily mean it is bug-free.
  226.    So, if you should encounter any problem with FullPalette, don't hesitate
  227. to contact me.
  228.  
  229.    For any comment, suggestion or bug report about FullPalette, write to:
  230.  
  231.    Massimo Tantignone
  232.    Via Campagnoli, 4
  233.    28100 Novara (NO)
  234.    ITALY
  235.  
  236.    E-mail: tanti@intercom.it
  237.  
  238.    I can't guarantee an immediate reply to everyone, but I'll certainly
  239. read all of your mails.
  240.  
  241.